-- *****************************************************************
-- Cisco Cable Diagnostic MIB
--
-- April, 2003 Lilian Jiang
--
-- Copyright (c) 2003 by cisco Systems, Inc.
-- All rights reserved.
-- *****************************************************************CISCO-CABLE-DIAG-MIB DEFINITIONS::=BEGIN
IMPORTSMODULE-IDENTITY,OBJECT-TYPE,Gauge32,Integer32,Unsigned32FROM SNMPv2-SMI
MODULE-COMPLIANCE,OBJECT-GROUPFROM SNMPv2-CONF
TruthValue,TimeStampFROM SNMPv2-TC
ifIndex
FROM IF-MIB
ciscoMgmt
FROM CISCO-SMI
;ciscoCableDiagMIB MODULE-IDENTITYLAST-UPDATED"200401150000Z"ORGANIZATION"Cisco Systems Inc. "CONTACT-INFO"Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-lan-switch-snmp@cisco.com"DESCRIPTION"This MIB module defines objects for managing cable
diagnostic test capabilites supported by the Cisco devices.
Cable diagnostic tests are tests intended to exercise
the functional integrity of the cable attached to a
physical interface.
Examples of cable diagnostic test methods are: PRBS
(Pesudo Random Binary Sequence), TDR (Time Domain
reflectometery), etc.."REVISION"200401150000Z"DESCRIPTION"Initial version of this MIB module."::={ ciscoMgmt 390}ciscoCableDiagMIBNotifs OBJECTIDENTIFIER::={ ciscoCableDiagMIB 0}
ciscoCableDiagMIBObjects OBJECTIDENTIFIER::={ ciscoCableDiagMIB 1}ciscoCableDiagMIBConform OBJECTIDENTIFIER::={ ciscoCableDiagMIB 2}ccdPrbsObjects OBJECTIDENTIFIER::={ ciscoCableDiagMIBObjects 1}ccdTdrObjects OBJECTIDENTIFIER::={ ciscoCableDiagMIBObjects 2}--
-- PRBS Test Objects
--ccdPrbsIfTable OBJECT-TYPESYNTAXSEQUENCEOF CcdPrbsIfEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table containing information about PRBS (Pesudo
Random Binary Sequence) test on the device's
interfaces. An entry appears in this table for each
interface which is capable to run PRBS test."::={ ccdPrbsObjects 1}ccdPrbsIfEntry OBJECT-TYPESYNTAX CcdPrbsIfEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry in the ccdPrbsIfTable, containing the information
about PRBS test on an interface."INDEX{ ifIndex }
::={ ccdPrbsIfTable 1}
CcdPrbsIfEntry ::=SEQUENCE{
ccdPrbsIfAction
INTEGER,
ccdPrbsIfActionStatus
INTEGER,
ccdPrbsIfTestErrors
Gauge32,
ccdPrbsIfTestErrorsResetTime
TimeStamp,
ccdPrbsIfTestErrorsMaxValue
Unsigned32}ccdPrbsIfAction OBJECT-TYPESYNTAXINTEGER{start(1),stop(2),errorReset(3),running(4),notRunning(5)}MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Indicates the PRBS test action to be executed on the interface
and whether the test is currently running or not.
'start' -- start the PRBS test on the interface.
'stop' -- stop the PRBS test on the interface.
'errorReset' -- reset the object value of
ccdPrbsIfTestErrors to zero on the interface.
'running' -- the PRBS test is currently running on the
interface. This value is a read-only value
and can not be set on the interface.
'notRunning' -- the PRBS test is currently not running
on the interface. This value is a read-only
value and can not be set on the interface."::={ ccdPrbsIfEntry 1}ccdPrbsIfActionStatus OBJECT-TYPESYNTAXINTEGER{succeeded(1),failedDueToUnknownReason(2),failedDueToResourceUnavailable(3),failedDueToInternalError(4),failedDueToTestAlreadyStarted(5),failedDueToTestAlreadyStopped(6),failedDueToInterfaceDisabled(7)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the status of the last PRBS test action set on the
interface."::={ ccdPrbsIfEntry 2}ccdPrbsIfTestErrors OBJECT-TYPESYNTAXGauge32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the number of errors which occurred during the
current or most recent running of a test. This Gauge is reset
to zero each time a test starts (e.g., when ccdPrbsIfAction
is set to 'start') or each time ccdPrbsIfAction is set
to 'errorReset' on an interface.
If and when an instance of ccdPrbsIfTestErrors reaches its
maximum value as indicated by the corresponding instance of
ccdPrbsIfTestErrorsMaxValue, its value will be less or equal
to the actual number of errors."::={ ccdPrbsIfEntry 3}ccdPrbsIfTestErrorsResetTime OBJECT-TYPESYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the most recent time that the corresponding
instance of ccdPrbsIfTestErrors is reset to zero. If the
the corresponding instance of ccdPrbsIfTestErrors is
never reset to zero, then the instance value for
ccdPrbsIfTestErrorsResetTime will be zero."::={ ccdPrbsIfEntry 4}ccdPrbsIfTestErrorsMaxValue OBJECT-TYPESYNTAXUnsigned32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the maximum value of the corresponding instance
of ccdPrbsIfTestErrors."::={ ccdPrbsIfEntry 5}--
-- TDR Objects
--ccdTdrIfTable OBJECT-TYPESYNTAXSEQUENCEOF CcdTdrIfEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table containing information about TDR
(Time Domain Reflectometery) test on the device's
interfaces. An entry appears in this table for each
interface which is capable to run TDR test."::={ ccdTdrObjects 1}ccdTdrIfEntry OBJECT-TYPESYNTAX CcdTdrIfEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry in the ccdTdrIfTable, containing the information
about TDR test on an interface."INDEX{ ifIndex }::={ ccdTdrIfTable 1}
CcdTdrIfEntry ::=SEQUENCE{
ccdTdrIfAction
INTEGER,
ccdTdrIfActionStatus
INTEGER,
ccdTdrIfLastTestTime
TimeStamp,
ccdTdrIfResultValid
TruthValue}ccdTdrIfAction OBJECT-TYPESYNTAXINTEGER{start(1),clear(2),running(3),notRunning(4)}MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Indicates the TDR test action to be executed on the interface
and whether the test is currently running or not.
'start' -- start the TDR test on the interface.
'clear' -- clear all the TDR test results on the interface.
After this action is executed on an interface,
the object value of ccdTdrIfResultValid for the
corresponding interface will be false(2).
'running' -- the TDR test is currently running on the
interface. This value is a read-only value
and can not be set on the interface.
'notRunning' -- the TDR test is currently not running
on the interface. This value is a read-only
value and can not be set on the interface."::={ ccdTdrIfEntry 1}ccdTdrIfActionStatus OBJECT-TYPESYNTAXINTEGER{succeeded(1),failedDueToUnknownReason(2),failedDueToResourceUnavailable(3),failedDueToInternalError(4),failedDueToTestAlreadyRunning(5),failedDueToInterfaceDisabled(6)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the status of the last TDR test action set on the
interface."::={ ccdTdrIfEntry 2}ccdTdrIfLastTestTime OBJECT-TYPE
SYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the timestamp when TDR test is last run
on the interface. If TDR test is never run on an
interface, then this object value will be zero."::={ ccdTdrIfEntry 3}ccdTdrIfResultValid OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates whether the TDR test result on the interface
is valid for the user to retrieve or not."::={ ccdTdrIfEntry 4}ccdTdrIfResultTable OBJECT-TYPESYNTAXSEQUENCEOF CcdTdrIfResultEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table containing information about TDR
test result on the device's interfaces. An entry
appears in this table for each cable pair on an interface
which has valid TDR test result, i.e., the value of
ccdTdrIfResultValid for the interface is true(1)."::={ ccdTdrObjects 2}ccdTdrIfResultEntry OBJECT-TYPESYNTAX CcdTdrIfResultEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry in the ccdTdrIfResultTable, containing
the information about TDR test on an interface."INDEX{ ifIndex, ccdTdrIfResultPairIndex }::={ ccdTdrIfResultTable 1}
CcdTdrIfResultEntry ::=SEQUENCE{
ccdTdrIfResultPairIndex
INTEGER,
ccdTdrIfResultPairChannel
INTEGER,
ccdTdrIfResultPairLength
Integer32,
ccdTdrIfResultPairLenAccuracy
Integer32,
ccdTdrIfResultPairDistToFault
Integer32,
ccdTdrIfResultPairDistAccuracy
Integer32,
ccdTdrIfResultPairLengthUnit
INTEGER,
ccdTdrIfResultPairStatus
INTEGER}ccdTdrIfResultPairIndex OBJECT-TYPESYNTAXINTEGER{pair1to2(1),pair3to6(2),pair4to5(3),pair7to8(4)}MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The local cable pair index.
'pair1to2' -- the pair with cable connectors 1 and 2.
'pair3to6' -- the pair with cable connectors 3 and 6.
'pair4to5' -- the pair with cable connectors 4 and 5.
'pair7to8' -- the pair with cable connectors 7 and 8."REFERENCE"IEEE 802.3-2002: Sections 40.8.1"::={ ccdTdrIfResultEntry 1}ccdTdrIfResultPairChannel OBJECT-TYPESYNTAXINTEGER{other(1),channelA(2),channelB(3),channelC(4),channelD(5)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The channels that the cable pair is connected to.
'other' -- none of the following.
'channelA' -- channel A.
'channelB' -- channel B.
'channelC' -- channel C.
'channelD' -- channel D."::={ ccdTdrIfResultEntry 2}ccdTdrIfResultPairLength OBJECT-TYPESYNTAXInteger32(-1..2147483647)MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The length of the cable pair. A value of -1 indicates
the length value is invalid. The unit of this value
is indicated by ccdTdrIfResultPairLengthUnit of the same
cable pair."::={ ccdTdrIfResultEntry 3}ccdTdrIfResultPairLenAccuracy OBJECT-TYPESYNTAXInteger32(-1..2147483647)MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The length accuracy of the cable pair. This value
should be added to and deducted from the value of
ccdTdrIfResultPairLength of the same cable pair to
form the upper and lower range of the cable pair length.
A value of -1 indicates the length accuracy value
is invalid. The unit of this value is indicated by
ccdTdrIfResultPairLengthUnit of the same cable pair. "::={ ccdTdrIfResultEntry 4}ccdTdrIfResultPairDistToFault OBJECT-TYPESYNTAXInteger32(-1..2147483647)MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The distance to the fault point of the cable pair.
A value of -1 indicates this value is invalid.
The unit of this value is indicated by
ccdTdrIfResultPairLengthUnit of the same cable pair."::={ ccdTdrIfResultEntry 5}ccdTdrIfResultPairDistAccuracy OBJECT-TYPESYNTAXInteger32(-1..2147483647)
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The accuracy of the distance to the fault point for
the cable pair. This value should be added to and
deducted from the value of ccdTdrIfResultPairDistToFault
of the same cable pair to form the upper and lower range
of the distance to fault point for the cable pair.
A value of -1 indicates this value is invalid.
The unit of this value is indicated by
ccdTdrIfResultPairLengthUnit of the same cable pair."::={ ccdTdrIfResultEntry 6}ccdTdrIfResultPairLengthUnit OBJECT-TYPESYNTAXINTEGER{unknown(1),meter(2),centimeter(3),kilometer(4)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The measurement unit on the length or the distance to fault
point for the cable pair.
'unknown' -- none of the following.
'meter' -- the unit is meter.
'centimeter' -- the unit is centimeter.
'kilometer' -- the unit is kilometer."::={ ccdTdrIfResultEntry 7}ccdTdrIfResultPairStatus OBJECT-TYPESYNTAXINTEGER{
unknown(1),terminated(2),notCompleted(3),notSupported(4),open(5),shorted(6),impedanceMismatch(7),broken(8)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The status of the cable pair.
'unknown' -- none of the following.
'terminated' -- the pair is properly terminated at the
remote end.
'notCompleted' -- the test on this pair is not completed.
'notSupported' -- the test on this pair is not supported.
'open' -- the pair is open.
'shorted' -- the pair is shorted.
'impedanceMismatch' -- the impedance of the pair is
mismatched.
'broken' -- the pair is broken."::={ ccdTdrIfResultEntry 8}--
-- Conformance
--ciscoCableDiagMIBCompliances OBJECTIDENTIFIER::={ ciscoCableDiagMIBConform 1}ciscoCableDiagMIBGroups OBJECTIDENTIFIER
::={ ciscoCableDiagMIBConform 2}ciscoCableDiagMIBComplianceRev1 MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for SNMP entities that implement the
CISCO-CABLE-DIAG-MIB."MODULE-- this module-- no MANDATORY-GROUPSGROUP ccdPrbsGroup
DESCRIPTION"This group is mandatory for implementations of PRBS cable
diagnostic test."GROUP ccdTdrGroup
DESCRIPTION"This group is mandatory for implementations of TDR cable
diagnostic test."::={ ciscoCableDiagMIBCompliances 1}--
-- Units of Conformance
--ccdPrbsGroup OBJECT-GROUPOBJECTS{
ccdPrbsIfAction,
ccdPrbsIfActionStatus,
ccdPrbsIfTestErrors,
ccdPrbsIfTestErrorsResetTime,
ccdPrbsIfTestErrorsMaxValue
}STATUScurrentDESCRIPTION"A collection of managed objects to support PRBS
cable diagnotic test on the interfaces of the device."::={ ciscoCableDiagMIBGroups 1}ccdTdrGroup OBJECT-GROUPOBJECTS{
ccdTdrIfAction,
ccdTdrIfActionStatus,
ccdTdrIfLastTestTime,
ccdTdrIfResultValid,
ccdTdrIfResultPairChannel,
ccdTdrIfResultPairLength,
ccdTdrIfResultPairLenAccuracy,
ccdTdrIfResultPairDistToFault,
ccdTdrIfResultPairDistAccuracy,
ccdTdrIfResultPairLengthUnit,
ccdTdrIfResultPairStatus
}STATUScurrentDESCRIPTION"A collection of managed objects to support TDR
cable diagnotic test on the interfaces of the device."::={ ciscoCableDiagMIBGroups 2}END